home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtMakeGeometryRequest.z / XtMakeGeometryRequest
Encoding:
Text File  |  2002-10-03  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXttttMMMMaaaakkkkeeeeGGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttMMMMaaaakkkkeeeeGGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtMakeGeometryRequest, XtMakeResizeRequest - make geometry
  10.           manager request
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XtGeometryResult XtMakeGeometryRequest(_w, _r_e_q_u_e_s_t,
  14.           _r_e_p_l_y__r_e_t_u_r_n)
  15.                 Widget _w;
  16.                 XtWidgetGeometry *_r_e_q_u_e_s_t;
  17.                 XtWidgetGeometry *_r_e_p_l_y__r_e_t_u_r_n;
  18.  
  19.           XtGeometryResult XtMakeResizeRequest(_w, _w_i_d_t_h, _h_e_i_g_h_t,
  20.           _w_i_d_t_h__r_e_t_u_r_n, _h_e_i_g_h_t__r_e_t_u_r_n)
  21.                 Widget _w;
  22.                 Dimension _w_i_d_t_h, _h_e_i_g_h_t;
  23.                 Dimension *_w_i_d_t_h__r_e_t_u_r_n, *_h_e_i_g_h_t__r_e_t_u_r_n
  24.  
  25.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  26.           _r_e_p_l_y__r_e_t_u_r_n
  27.                     Returns the allowed widget size or may be NULL if
  28.                     the requesting widget is not interested in
  29.                     handling _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t.
  30.  
  31.           _r_e_q_u_e_s_t   Specifies the desired widget geometry (size,
  32.                     position, border width, and stacking order).
  33.  
  34.           _w         Specifies the widget that is making the request.
  35.  
  36.           _w_i_d_t_h__r_e_t_u_r_n
  37.           _h_e_i_g_h_t__r_e_t_u_r_n
  38.                     Return the allowed widget width and height.
  39.  
  40.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.           Depending on the condition, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t performs
  42.           the following:
  43.  
  44.           +o    If the widget is unmanaged or the widget's parent is
  45.                not realized, it makes the changes and returns
  46.                _X_t_G_e_o_m_e_t_r_y_Y_e_s.
  47.  
  48.           +o    If the parent is not a subclass of _c_o_m_p_o_s_i_t_e_W_i_d_g_e_t_C_l_a_s_s
  49.                or the parent's geometry_manager is NULL, it issues an
  50.                error.
  51.  
  52.           +o    If the widget's being_destroyed field is _T_r_u_e, it
  53.                returns _X_t_G_e_o_m_e_t_r_y_N_o.
  54.  
  55.           +o    If the widget x, y, width, height and border_width
  56.                fields are all equal to the requested values, it
  57.                returns _X_t_G_e_o_m_e_t_r_y_Y_e_s; otherwise, it calls the parent's
  58.                geometry_manager procedure with the given parameters.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttMMMMaaaakkkkeeeeGGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttMMMMaaaakkkkeeeeGGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           +o    If the parent's geometry manager returns _X_t_G_e_o_m_e_t_r_y_Y_e_s
  75.                and if _X_t_C_W_Q_u_e_r_y_O_n_l_y is not set in the request_mode and
  76.                if the widget is realized, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t calls
  77.                the _X_C_o_n_f_i_g_u_r_e_W_i_n_d_o_w Xlib function to reconfigure the
  78.                widget's window (set its size, location, and stacking
  79.                order as appropriate).
  80.  
  81.           +o    If the geometry manager returns _X_t_G_e_o_m_e_t_r_y_D_o_n_e, the
  82.                change has been approved and actually has been done.
  83.                In this case, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t does no configuring
  84.                and returns _X_t_G_e_o_m_e_t_r_y_Y_e_s.  _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t never
  85.                returns _X_t_G_e_o_m_e_t_r_y_D_o_n_e.
  86.  
  87.           Otherwise, _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t returns the resulting value
  88.           from the parent's geometry manager.
  89.  
  90.           Children of primitive widgets are always unmanaged; thus,
  91.           _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t always returns _X_t_G_e_o_m_e_t_r_y_Y_e_s when
  92.           called by a child of a primitive widget.
  93.  
  94.           The _X_t_M_a_k_e_R_e_s_i_z_e_R_e_q_u_e_s_t function, a simple interface to
  95.           _X_t_M_a_k_e_G_e_o_m_e_t_r_y_R_e_q_u_e_s_t, creates a _X_t_W_i_d_g_e_t_G_e_o_m_e_t_r_y structure
  96.           and specifies that width and height should change.  The
  97.           geometry manager is free to modify any of the other window
  98.           attributes (position or stacking order) to satisfy the
  99.           resize request.  If the return value is _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t,
  100.           width_return and height_return contain a compromise width
  101.           and height.  If these are acceptable, the widget should
  102.           immediately make an _X_t_M_a_k_e_R_e_s_i_z_e_R_e_q_u_e_s_t and request that the
  103.           compromise width and height be applied.  If the widget is
  104.           not interested in _X_t_G_e_o_m_e_t_r_y_A_l_m_o_s_t replies, it can pass NULL
  105.           for width_return and height_return.
  106.  
  107.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  108.           XtConfigureWidget(3Xt), XtQueryGeometery(3Xt)
  109.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  110.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.